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COPYRIGHT (c) 1978, 1980, 1982, 1984 B 
DIGITAL EQUIPMENT 1 CORPO RATION, MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED 


THIS SOFTWARE {A ait UNDER A LICENSE AND MAY BE USED AND corte 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH bi¢ ENSE AND WITH TKE 
INCLUSION OF THE ABOVE git od NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
Taenetekeiee” NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITH 
CoRPORAT it NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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; Facility: FAL (DECmet File Access Listener) 

; Abstract: 


This module defines symbols for the FAL control blocks that are defined 
by the SFALWRKDEF and SFALSTSDEF macros. 


; Environment: 


The MDL translator must be used to convert FALDEF.MDL into 
FALDEF .MAR (and FALDEF.B32). 


; Author: James A. Krycka, Creation Date: 16-JUN-1977 
; Modified By: 
VO3-007 JAKO145 J A Krycka 12-APR-1984 


Track changes in DAP message building algorithm: rename 
FALSQ_XMT to FAL$Q_ BLD, rename FAL$Q_AUX to FALSQ_XMT, and 
remove FALS$L_AUX_PTR. 


v03-006 JAKO137 rycke 1984 
Add FALS$V_LOG_ cnt fone ng pa rieth, mg PALSV _DIS_PMR option. 


vO3-005 JAK0136 J A Krycka A ong 1984 
Expand the FAL work area to 8K bytes 
Extend size of Key Definition xX storage area. 
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v03-004 


v03-003 


v03-002 


v03-001 
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pepiece FAL$Q_NCB and FALS$T_NCBBUF ytth FAL$Q_FALLOG, 
FAL$T_FALLOG FALSQ_SYSNET and FAL T_SYSNET. 

Add FALST_PRIBUFT and FALST_PRTBUFO for FAL logging, 

Replace FALSL_LOGFLG with four subfields that identify FAL$LOG 
opecene by class. 

Also add several new fields to store FAL$LOG option values. 
General cleanup and reorganization. 


JAKO107 J A Krycka 06-MAY-1983 
Extend size of Protection XAB storage area. 


JAKO104 JA ccyeke 17-MAR=1983 
Add FALS$Q_RMS and FALSL_RMS_PTR. 

Add FAL$V_DIS_RBK Logging option, 

Add FALSV_TERMINATE flag. 


KRMO098 K Malik 06-Apr-1983 
Add FALSV_NEWNAM flag for use during a rename oeeretion to 
tell FALSENCODE_NAM and FALSLOG_RESNAM which NAM block to use. 


KRM0070 K Malik 23-Nov-1982 

Add FALSL_FAB2, FALSL_NAM2, FALST_NAMESPEC, FALST_EXPAND2, 
and FALST_RESULT2 for use by CREME, , 

Increase size of arrays to support 32 Allocation and Key 
Definition XABs. 

Change FAL$B_LOGFLG to FALS$L_LOGFLG. 

Rename some Symbols for consistency. 


FA 
Ta 


f ——— 


FALDEF.MDL; 1 


SSTRUCT FAL ,WRKDEF 


x RRR RKRRRKARR 
=z 


RCVEFN,1 
XMTEFN, 


MBXEFN 
MAxBUF S17 ,<64*512-1> 


2 AZBOmMr oO 
Z——20- 


z 
“” 
a 


> 
o- 
~ 


on 
——— 
-xz 
=. ] 

_— 

oO 


NEWNAM 
aan: 


RCVQIO 


LAST_MSG 


RET_RFA 
RET~RECN 
RETISTV 
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po+ 
|; SFALWRKDEF defines FAL work area offsets and symbols. 


Miscellaneous constants 

Link receive Q10 event flag 

Link transmit Q10 event flag 

Mailbox receive Q10 event flag 

Maximum DAP buffer size supported 

Minimum RMS multi-block cache size in blocks 
Maximum RMS multi-block cache size in blocks 
Default RMS multi-block cache size in blocks 


FAL status flags follow (bits 00-63): 

Define bits 32-39 as FAL logging options 
Define bits 49-47 as FAL enable options 

Define bits 48-55 as FAL disable options | 
Define bits 56-63 as FAl miscellaneous options 


DAP message state information: 
Processed Configuration message 
Processed Attributes message 


Miscellaneous state information: 
File transfer mode (vs record access mode) 
Block 1/0 mode (vs record 1/0 mode) 
This is a wildcard operation (dete*mined 
via parse of filespec string) ; 
Use NAM2 block (used during rename operation) 
FAL has entered termination sequence 


QI0 related state information. 
Link receive Q10 guestend ing flag 
Link receive AST delivered ae 
Link transmit Q10 guestandin lag 
Link transmit AST delivered flag 
Mailbox receive Q10 quegtanding flag 
Mailbox receive AST delivered flag 


Routine call function modifiers: 
(The next bit is input to FALSTRANSMIT) 
Last DAP message in sequence to be bloried 
(The next 3 bits are input to FALSENCUDE_STS) 
Include RFA field in Status message 
Include RECNUM field in Status message 
Include STV field in Status message 
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LOG_AST 
LOG_a10 
LOG_CNT 
LOG-B1Te 
ENA_B1TO 
7 
DIS_CRC 
DIS-MBK 
DIS"RBK 
DIS_PMR 
DIS_BIT4 
3 


PARSE_ERR 
USE_DBS 
USE~SYS 


USE_VER 
USE-SC1 


USE _SC2 
2 
> 


STATE_CTX,0 
5 TBL-ADDR,O 


RBK CACHE .B 
Q16BUFSIZ,W 
DAPBUF S1Z,W 


LNKCHN,W 
MBXCHN.W 
RCVIOSB,Q 
XMTIOSB.Q 
MBX10SB.0 
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conper ioe 

Enable logging of DAP message packet Q10 
requests 

Enable logging of internal counters 

Spare 


These flags enable FAL features: 
Spare 


These flags disable FAL features: 
Disable file Level CRC checksum computation 
Disable DAP message pb 
Disable RMS multi=block caching to/from 
disk during block 1/0 file transfer mode 
Disable poor-man's routing (i.e., reject any 
sen nnenee received that contains a nodename 
pare 


These flags signal a parsing failure or denote 
qualifiers which require additional processing 
Error in parse of FAL$LOG equivalence string 

Use specified DAP buffer size 
Use specified 2-byte operating system and 
ile system type identification 
Use specified 4-byte DAP version number value 
Use specified 32-bit value as first part of 
system capabilities mask to send 
Use specified 32-bit value as second part of 
system capabilities mask to send 


State table address 
Current table entry address 
State transition value 
Receive buffer index (into address table) 
Number of blocks in RMS multi-blocking cache 
Unused locations 
Larges Q10 request that can be supported by 
FAL (i.e., buffer size available) 


; Maximum DAP message size (determined via 


exchange of Configuration messages) 
Link channel # 


; Associated mailbox channel # 

; Link receive 1/0 status block 

; Link transmit 1/0 status block 

; Mailbox receive 1/0 status block 
; Mailbox message descriptor block 
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RCV,Q 
XMT,Q 


BLD,Q 
el 
RC 


RMS PTR,L 
DISPLAY ,W 


RECEIVED ,W 


> 
ALLXABINI,L 
KEYXABINI,L 
CHAIN_NXT.L 


VOLNAME ,Q 
DIRNAME ,Q 
FALLOG,Q 
SYSNET,Q 


ol 
DATATYPE ,B 
ACCOPT,.B 
ACCFUNC .B 


C, 


FOP. L 
NUMBER ,L 


VBUF .L,2 
K RCVBUFCNT,2 
RMS ,Q 
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Receive DAP message descriptor 
Transmit DAP message descriptor 
(used for tee tig DAP messages) 
Build DAP message descriptor 
(used in building a new DAP message) 
(note that BLD buffer overlays XMI buffer) 


pare 
Receive buffer address table 
Number of receive buffers 
RMS block buffer oye! tig! 
Next ayes pointer for RMS block buffer 
Mask of optional DAP messages to return 
(copy of DAP$W_DISPLAY1 or DAP$W_DISPLAY2) 
Mask of received XABs to Link to RAB chain 
(i.e., XABS generated as a result of 
receiving optional DAP messages) 
Meaning: 
Key Definition XAB(s) 
Allocation XAB(s) 
Date and Time XAB 
Protection XAB 
Revision Date and Time XAB 


Bit vector of Allocation XABs initialized 
Bit vector of Key Definition XABs initialized 
Address of last pointer cell in XAB chain 


eeeeeneer offset = *“X0080 = 128 xeeeeeee 
(VOLNAME and DIRNAME must be contiguous) 
Volume name descriptor (for 3-part name) 

Directory name descriptor (for 3-part name) 

FAL$LOG equivalence string descriptor 

SYSSNET equivalence string descriptor (which 
will be made into an NCB descriptor) 

User entered DAP buffer size 

User entered 2-byte operatin ayatee and file 
system type identification field 

User entered 4-byte DAP version number field 

User entered system capabilities mask coe 1) 
User entered system capabilities mask (31-63) 

Unused locations 

Statistics block 

Statistics block size 

DAP control block storage area 

DAP control block size 


; Reserved for future expansion of DAP structure 


Unused locations 


eererere atteet a “0200 = 512 seeeeere 
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F PAB Lo FAB storage area 
K FAB,80 AB size 
F RAB,L,17 RAB storage area 
K RAB,68 RAB size 
F NAM,L,24 NAM block storage area 
K NAM,96 NAM control block size 
F FHCXAB,L,11 File Header Characteristics XAB storage area 
K FHCXAB,44 File Header Characteristics XAB size 
F DATXAB,L,11 Date and Time XAB storage area 
K DATXAB,44 Date of Time XAB size 
F PROXAB,L,22 Protection XAB storage area 
K PROXAB,88 Protection XAB size 
F SUMXAB,L, Summary XAB storage area 
K SUMXAB,12 Summary XAB size 
F RDTXAB,L,5 Revision Date and Time XAB storage area 
K RDTXAB,20 Revision Date and Time XAB size 
A Unused locations 
F TEMP ,L Temporary longword work area 
F TEMP,Q Temporary quadword work area 


File specification string buffer 

File specification string buffer size 
Expanded name string buffer 

Expanded name string buffer size 
Resultant name string buffer 
Resultant name string buffer size 

Key buffer 

Key buffer size 


RMS structures for use by RENAME operation 
(FAB2 and NAM2 must be contiguous) 

FAB storage area 

FAB size 

NAM storage area 

NAM si 


size 
Unsued locations 


eeeeerer offset = “XOCO0 = 3072 eeeeeeer 


Allocation XAB storage area 
Allocation XAB size 


F Al 
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KEYXAB,L,19 
YXAB,76 


a 
MBXBUF ,T,64 
K MBXBUF .64 
K MBXQUOTA, <64#2> 


PRIBUF1,T 
PRTBUF2.T 
K PRTBUF, 


1 

KEYNAM,L,8 

K KEYNAM, 32 
8 

1 


FALLOG,T 
K FALLOG 
T 
T 


K VOLNAM 
DIRNAME , 
K DIRNAM 


m 
mem —<9 sss 


WRKBLN 


16-SEP-1984 16:38:28.5 Page 7 


eteneree offset = *X1000 = 4096 seeeeeee 


aie buffer 
Mailbox buffer size 
Mailbox quota 
Unused locations 


keneneee offset = _"X1A00 = 6656. generar 
Primary (non-AST- level) print buffer 
pocentary (AST=Llevel) print buffer 

Print buffer size (for FAL logging) 


eerereee offset = *x1000 = 7168 seeeeere 
Key Name buffer 

Key Name byf ter size 

Space for 31 alternate Key Name buffers 


Logical name “translation buffer + pal FALSLOG 

Logical name translation buffer s 

Logical name translation buffer for * SYSSNET 

Logical name translation buffer size 

Volume name ed nod buffer (to store 
(concatenated node specs plus device name) 

Volume name string buffer size 

Directory name string buffer 

Directory name string buffer size 


Define length of this control block 
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5¢¢ 
; SFALSTBDEF defines FAL statistics block offsets and symbols. 


$SSTRUCT FAL,STBDEF 
F RCV_PKT,L ; Total # DAP message packets received 
F RCV_MSG,L :; Total # DAP messages received 
F RCV_DAT,L ; Total # records/blocks received 
3 (i.e., # DAP Data mesenges: 
F RCV_USR,L ; Total # bytes of user data received 
; (i.e., # pytee in all records/blocks) 
F RCV_LNK,L ; Total # rycee of Link data received 
3 (i.e., # bytes in all DAP messages) 
F XMT_PKT,L ; Total # DAP message packets transmitted 
F XMT_MSG,L :; Total # DAP messages transmitted 
F XMT_DAT,L : Total # records/blocks transmitted 
3 (i.e., # DAP Data messages) 
F XMT_USR,L ; Total # oycee of user data transmitted 
; (i.e., # bytes in all records/blocks) 
F XMT_LNK,L ; Total # bytes of Link data transmitted 
: (i.e., # bytes in all DAP messages) 
F ,L,6 ; Unused locations 
tL STBBLN ; Define length of this control block 


End of module 
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